This chapter describes the GWCON process and includes the following sections:
The Gateway Console (monitoring) process, GWCON (also referred to as CGWCON), is a second-level process of the device user interface.
Using GWCON commands, you can:
The GWCON command interface is made up of levels called modes. Each mode has its own prompt. For example, the prompt for the SNMP protocol is SNMP>.
If you want to know the process and mode you are communicating with, press enter to display the prompt. Some commands in this chapter, such as the network and protocol commands, allow you to access the various modes in GWCON.
To enter GWCON from OPCON (*), choose one of the following methods:
* console
* status
Then, enter the talk command followed by the PID number for GWCON:
* talk 5
The console displays the GWCON prompt (+). If the prompt does not appear, press enter. Now you can enter GWCON commands.
To return to OPCON, enter the OPCON intercept character. (The default is Ctrl-P.)
This section contains the GWCON commands. Each command includes a description, syntax requirements, and an example. The GWCON commands are summarized in Table 12.
To use the GWCON commands, access the GWCON process by entering talk
5 and enter the GWCON commands at the (+) prompt.
Table 12. GWCON Command Summary
| Command | Function |
|---|---|
| ? (Help) | Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help". |
| Activate | Enables a newly configured spare interface. |
| Buffer | Displays information about packet buffers assigned to each interface. |
| Clear | Clears network statistics. |
| Configuration | Lists status of the current protocols and interfaces. |
| Disable | Takes the specified interface or slot off line. |
| Disk | Lists, retrieves, and deletes service-related files. |
| Enable | Enables all interfaces. |
| Error | Displays error counts. |
| Event | Enters the Event Logging System environment. |
| Feature | Provides access to console commands for independent device features outside the usual protocol and network interface console processes. |
| Interface | Displays network hardware statistics or statistics for the specified interface. |
| Memory | Displays memory, buffer, and packet data. |
| Network | Enters the console environment of the specified network. |
| Performance | Provides a snapshot of the main processor utilization statistics. |
| Protocol | Enters the command environment of the specified protocol. |
| Queue | Displays buffer statistics for a specified interface. |
| Reset | Disables the specified interface and then re-enables it using new interface, protocol and feature configuration parameters. |
| Statistics | Displays statistics for a specified interface. |
| Test | Enables a disabled interface or tests the specified interface. |
| Uptime | Displays time statistics for the device. |
Use the activate command to enable a spare interface on this device. See "Configuring Spare Interfaces" for more information.
Syntax:
Use the buffer command to display information about packet buffers assigned to each interface or range of interfaces.
| Note: | Each buffer on a device is the same size and is dynamically built. Buffers vary in size from one device to another. |
To display information about one interface only, enter the interface or network number as part of the command. To obtain the interface number, use the GWCON configuration command.
Syntax:
To display information about multiple interfaces, specify the range_of_network# (or a combination of network# and range_of_network#). For example, specifying buffer 0 3 25-50 displays the information for nets 0, 3, and 25 through 50.
Example:
+buffer
Input Buffers Buffer sizes Bytes
Net Interface Req Alloc Low Curr Hdr Wrap Data Trail Total Alloc
0 PPP/0 24 24 4 24 87 92 2044 17 2240 53760
1 PPP/1 24 24 4 24 87 92 2044 17 2240 53760
2 PPP/2 24 24 4 24 87 92 2044 17 2240 53760
3 PPP/3 24 24 4 24 87 92 2044 17 2240 53760
4 TKR/0 40 40 7 40 85 92 18144 7 18328 733120
5 TKR/1 40 40 7 0 85 92 2052 7 2236 89440
6 TKR/2 40 40 7 0 85 92 2052 7 2236 89440
7 TKR/3 40 40 7 40 85 92 18144 7 18328 733120
8 TKR/4 40 40 7 40 85 92 18144 7 18328 733120
9 Eth/0 64 64 10 64 84 92 1500 4 1680 107520
10 Eth/1 64 64 10 0 84 92 1500 4 1680 107520
Notes:
| Note: | The number of receive buffers allocated is less than the number of receive buffers requested if there is not enough memory available to allocate the requested number of buffers. |
Use the clear command to delete statistical information about one or all of the device's network interfaces. This command is useful when tracking changes in large counters. Using this command does not save space or speed up the device.
Enter the interface (or net) number as part of the command. To get the interface number, use the GWCON configuration command.
Syntax:
To clear information about multiple interfaces, specify the range_of_network# (or a combination of interface# and range_of_interface#). For example, specifying clear 0 3 25-50 clears the information for nets 0, 3, and 25 through 50.
Use the configuration command to display information about the protocols and network interfaces. The output is displayed in three sections, the first section lists the device identification, software version, boot ROM version, and the state of the auto-boot switch. The second and third sections list the protocol and interface information.
Syntax:
To display information about multiple interfaces, specify the range_of_network# (or a combination of network# and range_of_network#). For example, specifying configuration 0 3 25-50 displays the information for nets 0, 3, and 25 through 50.
Example:
configuration Access Integration Services 2212-AIS Feature 3763 V3.2 Mod 0 PTF 0 RPQ 0 AIS.EH5 cc_156c Num Name Protocol 3 ARP Address Resolution 7 IPX NetWare IPX 11 SNMP Simple Network Management Protocol 23 ASRT Adaptive Source Routing Transparent Enhanced Bridge 24 HST TCP/IP Host Services 25 LNM LAN Network Manager Num Name Feature 2 MCF MAC Filtering 7 CMPRS Data Compression Subsystem 9 DIALs Dial-in Access to LANs 10 AUTH Authentication 11 Total Networks: Net Interface MAC/Data-Link Hardware State 0 PPP/0 Point to Point SCC Serial Line Up 1 PPP/1 Point to Point SCC Serial Line Down 2 PPP/2 Point to Point SCC Serial Line Down 3 PPP/3 Point to Point SCC Serial Line Down 4 TKR/0 Token-Ring/802.5 IBM Token Ring Up 5 TKR/1 Token-Ring/802.5 IBM Token Ring Not present 6 TKR/2 Token-Ring/802.5 IBM Token Ring Not present 7 TKR/3 Token-Ring/802.5 IBM Token Ring Up 8 TKR/4 Token-Ring/802.5 IBM Token Ring Up 9 Eth/0 Ethernet/IEEE 802.3 10/100 Ethernet Up 10 Eth/1 Ethernet/IEEE 802.3 10/100 Ethernet Down
The following information is displayed for protocols:
The following information is displayed for features:
The following information is displayed for networks:
When an interface is operational, the interface periodically sends out maintenance packets and/or checks the physical state of the port or line to ensure that the interface is still functioning correctly. If the maintenance fails, the interface is declared down and a self-test is scheduled to run in 5 seconds. If a self-test fails, the interface transitions to the down state and the interval until the next self-test is increased up to a maximum of 2 minutes. If the self-test is successful, the network is declared up.
When an interface is disabled, it remains disabled until one of the following methods is used to enable it:
WAN Reroute also can change the state of a disabled interface. If an interface is configured as an alternate interface for WAN Reroute and its configured state is disabled, WAN Reroute will start a self-test of the interface when the primary interface goes down. When the primary interface is operational and stable again, WAN Reroute puts the alternate interface back to its configured state. Refer to The WAN Reroute Feature in Using and Configuring Features for more information.
Not Present is also used as the state for a null device. Spare interfaces are displayed as null devices until they are activated.
Use the disable command to take a network interface or slot off-line, making the interface or slot unavailable. This command immediately disables the interface or slot. You are not prompted to confirm, and no verification message displays. If you disable an interface or slot with this command, it remains disabled until you use the GWCON test command or an OPCON restart or reload command to enable it.
Enter the interface or net number or slot as part of the command. To obtain the interface number or slot number, use the GWCON configuration command.
| Note: | The 2212 compression/encryption device is a coprocessor. The command disable slot is not applicable to the coprocessor. Use the disable coprocessor command to disable each interface. |
| Note: | If the interface you are disabling is configured as an alternate WAN Reroute interface, you are asked if you want to disable any WAN Reroute primary/alternate pairings that include this alternate interface. If you answer yes, the interface is disabled and is no longer available to backup a primary interface. If you answer no, the alternate interface is disabled but WAN Reroute will attempt to bring it up if its corresponding primary interface goes down. You want to disable WAN Reroute on an alternate interface if you are disabling the interface so that you can remove its adapter. See The WAN Reroute Feature, Using WAN Restoral, and Configuring and Monitoring WAN Restoral in the Using and Configuring Features for additional information. |
Syntax:
The disable coprocessor command will disable the compression/encryption device and all the compression/encryption operations will be diverted to the software device.
Use the disk command to list, retrieve, or delete service-related files from the hard disk. The following categories of files can be listed, retrieved, or deleted: APPN, Adapter, ELS, SYSTEM or other (other files are ones that do not fit into another category). Only files that are actually located are listed. The following information is provided for the files that are located: name, comment that tells what the file is, size of the file, and the date that the file was created. For the system dump files, additional information is given about the dump. When retrieving or deleting a file, you are prompted to confirm the command. For retrieving a file, you will also need to provide the destination IP address that defines where the file should be sent and the name to be given to the file when it is written.
Syntax:
The categories are: adapter, appn, els, other, and system.
Example:
+disk list system 'core' Master System dump file (uncompressed) Size: 268435456 bytes Date: Tues Apr 06 10:054:30 1999 'core0.cmp' System dump file (compressed) Size: 11208443 bytes Date: Tues Apr 06 10:15:28 1999 'core1.cmp' System dump file (compressed) Size: 11150344 bytes Date: Tues Apr 06 10:54:30 1999 There are 3 different files Do you want to see the details of the compressed dumps? [No]: n
Use the Enable command to enable all interfaces of an adapter. This performs the same action as the test command (see "Test") but performs the action for each interface using the adapter in the specified slot.
| Note: | The 2212 compression/encryption device is a coprocessor. The command enable slot command is not applicable to the coprocessor. Use the enable coprocessor command to enable each interface. |
Syntax:
The enable coprocessor command will enable the compression/encryption device and all the compression/encryption operations will be diverted to the hardware device.
Use the error command to display error statistics for the network. This command provides a group of error counters.
Syntax:
To display information about multiple interfaces, specify the range_of_network# (or a combination of network# and range_of_network#). For example, specifying error 0 3 25-50 displays the information for nets 0, 3, and 25 through 50.
Example:
+error
Input Input Input Input Output Output
Net Interface Discards Errors UnkProto Flow Drop Discards Errors
0 PPP/0 0 0 0 0 0
0
1 PPP/1 0 0 0 0 0
0
2 PPP/2 0 0 0 0 0
0
3 PPP/3 0 0 0 0 0
0
4 TKR/0 0 0 21 0 0
0
5 TKR/1 0 0 0 0 0
0
6 TKR/2 0 0 0 0 0
0
7 TKR/3 0 0 17 0 0
0
8 TKR/4 0 0 22 0 0
0
9 Eth/0 0 0 0 0 0
0
10 Eth/1 0 0 0 0 0
0
| Note: | The sum of the discarded output packets is not the same as input flow drops over all networks. Discarded output may indicate locally originated packets. |
Use the event command to access the Event Logging System (ELS) console environment. This environment is used to set up temporary message filters for troubleshooting purposes. All changes made in the ELS console environment will take effect immediately, but will go away when the device is reinitialized. See "Using the Event Logging System (ELS)" for information about the Event Logging System and its commands. Use the exit command to return to the GWCON process.
Syntax:
Use the feature command to access console commands for specific 2212 features outside of the protocol and network interface console processes.
Enter a question mark after the feature command to obtain a listing of the features available for your software release.
To access that feature's console prompt, enter the feature command at the GWCON prompt followed by the feature number or short name. Table 9 lists available feature numbers and names.
Once you access the prompt for that feature, you can begin entering specific commands to monitor that feature. To return to the GWCON prompt, enter the exit command at the feature's console prompt.
Syntax:
Use the interface command to display statistical information about the network interfaces (for example, Ethernet). This command can be used without a qualifier to provide a summary of all the interfaces or with a qualifier to reveal detailed information about one specific interface.
Descriptions of detailed output for each type of interface are provided in the specific interface Monitoring chapters found in this guide. To obtain the interface number, use the GWCON configuration command.
Syntax:
To display information about multiple interfaces, specify the range_of_network# (or a combination of interface# and range_of_interface#). For example, specifying interface 0 3 25-50 displays the information for nets 0, 3, and 25 through 50.
Example: interface
+interface
Self-Test Self-Test Maintenance
Net Net' Interface Passed Failed Failed
0 0 PPP/0 2 0
0
1 1 PPP/1 0 165
0
2 2 PPP/2 0 165
0
3 3 PPP/3 0 165
0
4 4 TKR/0 Slot: 5 Port: 1 1 0
0
5 5 TKR/1 Slot: 1 Port: 1 0 0
0
6 6 TKR/2 Slot: 1 Port: 2 0 0
0
7 7 TKR/3 Slot: 2 Port: 1 1 0
0
8 8 TKR/4 Slot: 2 Port: 2 1 0
0
9 9 Eth/0 Slot: 3 Port: 1 1 0
0
10 10 Eth/1 Slot: 3 Port: 2 0 125
0
| Note: | The following information may be displayed. The display varies depending on the device. |
Use the memory command to display the current CPU memory usage in bytes, the number of buffers, and the packet sizes.
To use this command, free memory must be available. The number of free packet buffers may drop to zero, resulting in the loss of some incoming packets; however, this does not adversely affect device operations. The number of free buffers should remain constant when the device is idle. If it does not, contact your service representative.
Syntax:
Example:
memory
Physical installed memory: 16 MB
Total routing (heap) memory: 12 MB
Routing memory in use: 13 %
Total Reserve Never Perm Temp Prev
Alloc Alloc Alloc Alloc
Heap memory 12231155 26488 10687312 1438487 104924 432
Number of global buffers: Total = 300, Free = 300, Fair = 77, Low = 60
Global buff size: Data = 2048, Hdr = 17, Wrap = 72, Trail = 65, Total = 2208
Number of global buffers:
Use the network command to enter the console environment for supported networks, such as X.25 networks. This command obtains the console prompt for the specified interface. From the prompt, you can display statistical information, such as the routing information fields for Token-Ring networks.
Syntax:
At the GWCON prompt (+), enter the configuration command to see the protocols and networks for which the device is configured. See "Configuration" for more information on the configuration command.
Enter interface at the + prompt for a display of the networks for which the device is configured.
Enter the GWCON network command and the number of the interface you want to monitor or change. For example:
+network 3
X.25>
In the example, the X.25> prompt is displayed. You can then view information about the X.25 interface by entering the X.25 operating commands.
After identifying the interface number of the interface you want to monitor, for interface-specific information, see the corresponding monitoring chapter in this manual for the specified network or link-layer interface. Console support is offered for the following network and link-layer interfaces:
Use the performance command at the GWCON prompt to enter the monitoring environment for performance. See "Configuring and Monitoring Performance" for more information.
Use the protocol command to communicate with the device software that implements the network protocols installed in your device. The protocol command accesses a protocol's command environment. After you enter this command, the prompt of the specified protocol appears. From the prompt, you can enter commands that are specific to that protocol.
Syntax:
Enter the protocol number or short name as part of the command. To obtain the protocol number or short name, enter the CONFIG command environment (Config>), and then enter the list configuration command. See "Accessing the Configuration Process, CONFIG (Talk 6)" for instructions on accessing Config>. To return to GWCON, enter exit.
See the corresponding monitoring chapter in this manual or in the Protocol Configuration and Monitoring Reference for information on a specific protocol's console commands.
Use the queue command to display statistics about the length of input and output queues on the specified interfaces. Information about input and output queues provided by the queue command includes:
Syntax:
To display information about multiple interfaces, specify the range_of_network# (or a combination of interface# and range_of_interface#). For example, specifying queue 0 3 25-50 displays the information for nets 0, 3, and 25 through 50.
To display information about one interface only, enter the interface or network number as part of the command. To obtain the interface number, use the GWCON configuration command.
Input Queue:
Output Queue:
| Note: | When Bandwidth Reservation (BRS) is configured for PPP and Frame Relay interfaces, the output fair value is ignored and the queue lengths configurable with BRS are used to determine if a packet should be discarded due to flow control. |
If a packet is received and the input queue current value is less than the input queue low threshold value, then the packet will be subject to flow control. For locally originated packets, a packet is subject to flow control if the number of free global buffers is less than the low threshold for global buffers. If a packet subject to flow control is to be transmitted on a device which has an output queue current value that is greater than the output queue high threshold (fair), then the packet is dropped instead of queued. When a packet is dropped due to flow control, the output discards counter is incremented and ELS event GW.036 or GW.057 is logged. If the packet was not locally originated, the input flow drop counter for the input interface is incremented. The output discards and input flow drop counters are displayed by the GWCON error command.
Due to the scheduling algorithms of the device, the dynamic numbers of Curr (particularly the Input Queue Curr) may not be fully representative of typical values during packet forwarding. The console code runs only when the input queues have been drained. Thus, Input Queue Curr will generally be nonzero only when those packets are waiting on slow transmit queues.
Use the reset command to disable the specified interface and then re-enable it using new interface, protocol and feature configuration parameters. See "Resetting Interfaces" for more information.
Syntax:
Use the statistics command to display statistical information about the network software, such as the configuration of the networks in the device.
Syntax:
To display information about multiple interfaces, specify the range_of_network# (or a combination of interface# and range_of_interface#). For example, specifying statistics 0 3 25-50 displays the information for nets 0, 3, and 25 through 50.
To display information about one interface only, enter the interface or network number as part of the command. To obtain the interface number, use the GWCON configuration command.
Example:
+statistics
Net Interface Unicast Multicast Bytes Packets Bytes
Pkts Rcv Pkts Rcv Received Trans Trans
0 PPP/0 9815 0 371690 9815 371690
1 PPP/1 0 0 0 0 0
2 PPP/2 0 0 0 0 0
3 PPP/3 0 0 0 0 0
4 TKR/0 1542 19035 968165 40455 23191382
5 TKR/1 0 0 0 0 0
6 TKR/2 0 0 0 0 0
7 TKR/3 74578 32850 114045027 52537 51234542
8 TKR/4 49653 19228 52034171 87285 113444199
9 Eth/0 0 10 670 2438 146280
10 Eth/1 0 0 0 0 0
Use the test command to verify the state of an interface or to enable an interface that was previously disabled with the disable command. If the interface is enabled and passing traffic, the test command will remove the interface from the network and run self-diagnostic tests on the interface.
Syntax:
| Note: | For this command to work, you must enter the complete name of the command followed by the interface number. |
Enter the interface or network number as part of the command. To obtain the interface number, use the GWCON configuration command. For example, when testing starts, the console displays the following message:
Testing net 0 Eth/0...
When testing completes or fails, or when GWCON times out (after 30 seconds), the following possible messages are displayed:
Testing net 0 Eth/0 ...successful Testing net 0 Eth/0 ...failed Testing net 0 Eth/0 ...still testing
Some interfaces may take more than 30 seconds before testing is done.
| Note: | If the interface you are testing is configured as an alternate WAN Reroute
interface, you are prompted:
See The WAN Reroute Feature, Using WAN Restoral, and Configuring and Monitoring WAN Restoral in the Using and Configuring Features for additional information. |
Use the uptime command to display time statistics about the device, including the following:
Syntax: